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An IBM BPM Lab on integrating with SCA/BPEL and beyond 

In the IBM BPM Advanced product we have the powerful capability of mixing BPMN business 
level processes with powerful technical integration capabilities for including back-end 
systems. The purpose of this lab exercise is to illustrate an example integration between the 
business processes modeled in BPMN using the Process Designer tooling and the technical 
integration to existing back-end systems easily achieved in the Integration Designer tooling. 
Whether you follow this lab and build it out yourself or simply read and follow it in your mind, it 
is hoped that you will find something of interest. 


A Sales order 

Imagine we are responsible for running a company that makes custom widgets of different 
types. When a sales order arrives, we have to manufacture the widgets to the customer's 
specification. Because we desire to be an SOA company, we want to have a Manufacture 
service that owns the creation of the widgets. 

We can imagine a business process that handles orders that may look as follows: 


Start 




The step in the process known as Manufacture is responsible for manufacturing the widgets. 
This step could easily be created as a sub-process within BPMN but we have choices. In this 
story, we are going to assume that it is a distinct service that has been chosen to be 
implemented as an Advanced Integration Service (AIS) using the Integration Designer 
development tooling. 

From an implementation standpoint, the Manufacturing service will receive a request to 
manufacture widgets and performs two primary activities. 
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The first is the recording of the manufacturing request to our manufacturing database. We 
want to do this so that we have a record of the work being started and what precisely was 
requested to be constructed. This means interacting with a database system ... this is not 
something that a Business User would be able to achieve in their Business Processes. 

Once the record has been added to the database, we want to then invoke a pre-existing 
Service that sends a request to the factory floor to begin the construction of the widgets. This 
existing service happens to be defined as a Web Service. We could imagine this service 
being implemented by an assembly machine or as simply work items delivered to factory floor 
staff. 

We will assume that the input to the Manufacturing service will be a sales order that will 
logically look as follows: 


0 Sales Order 

< Click to filter...> 

[|] orderNumber int 
[i] widgetColor string 
[e] widgetSize int 
[1] widgetWeight float 


Since our new Manufacturing service is to be an exposed service, we need to describe the 
logical Interface it poses so that others may invoke it. 
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Name 

Type 

▼ startPreduction 

C>] Inputs 

order 

Sales Order 

10 Outputs 

result 

string 


This is the specification of our story. In the remaining sections, it is assumed that you have 
some experience with IBM's BPM products. You don't need to be a rocket surgeon to achieve 
the tasks but a little knowledge if expected. 

Let us start to build this out. 

_1. Start Integration Designer 

Launch integration designer through the usual mechanism that you use to start it on other 
occasions. 


2. Add a new integration project 


An integration project (which is also known as an SCA module) is the container in which we 
will define our other artifacts. Think of it as a named project that keeps the pieces of our 
solution grouped together. 


r- 

© business Integration - Getting Started - IBM Integration Designer - IBM Integration Desri 
File Edit Navigate Search Project Window Help 

T S? : [af _[ ii S? w 


H Business Integration 


Mil © ffl \m | b ^ 


call resources:* 

Click to add a business integration project... 

Switch to Process Center perspective 


Getting Started - IBM Integration Desic 


Getting Started u 
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We call our new module "Manufacturing". 
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At the completion of this step we now have an integration project ready for us to add the other 
artifacts that we may wish to use. 


_3. Create a Business Object 

In our story we have the concept of a SalesOrder. This is an order from a customer that 
needs to be built. We will now create the definition of the SalesOrder to allow us to 
describe what information it may contain. A data structure in an SCA Module is called a 
Business Object. 


5 





























Business Integration £3 


I □ 


<al resources?* 
j Manufacturing 

^5 Assembly Diagram 
2 Dependencies 
Integration Logic 


■ Data 


1 Inte 

Mi™ 


New 

Open 

Bft Co p y 

jjtj Paste 
H Delete 

r?' M| n Import.. 


Q Getting Started - IBM Integration Designer [^§1 Manufacturing - Assembly Diagram £3 


Palette 




123 Favorites 


IS? Components 
Lr ' Untyped Compo.. 

at Human Task 
rZJ i.... 


Project 

0 Business Object 
[jf Business Object from External Data 

[=5 Other... 


We give our new Business Object the name SalesOrder. 



Once we have created the empty Business Object definition, we add a series of fields to it. 
We give each field a name and an associated data type. The field names correspond to the 
intent we would use them for. 

0 SalesOrder 

< Click to filter...* 

[e] orderNumber int 
[e] widgetColor string 
[i] widgetSize int 
[e] widgetWeight double 
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Create an interface 


4. 


In an SOA solution, we have the concept of service providers and service callers. The 
provider exposes itself for use via an Interface that describes the operations it is willing to 
perform and also the parameters expected for those operations. Now it is time to create the 
Interface for the Manufacturing service. 


Business Integration £3 = Q 

^§1 Manufacturing - Assembly Diagram 

(Dl @| ffl®| <&| B % ~ 

<] § Palette 


<all resources^ T 

a Manufacturing 

^§1 Assembly Diagram 

S Dependencies 
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> \Q Data 
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IS? Favorites 

S? Components 
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ft|) Human Task 
^ Java 

m Transfi New > 


£3 


Project 


Open 

Copy 

Paste 


(Tj Interface 
[=3 Other... 



Delete 


rijm Import... 
hlZji Export... 

^ Refresh 


Team 


► 


We call our new interface Manufacturing. 


7 



























Interfaces need operations. The operation describes the signature of the functions exposed 
from the service. We create an operation called startProduction that takes as input a 

SalesOrder. 


▼Interface 


Configuration 


Name 

Manufacturing 

Refactor name 

Namespace 

http ://M a n uf a ctu ri n g/M a n uf a ctu ring 

Refactor namespace 

Binding Style 

document literal wrapped 

Chanae binclino stvleto document literal non-wrapped More... 


(1) Manufacturing £3 


▼Operations 


* 


s* p m I m 


Operations and their parameters 



Name 

Type 

w ^ startProduction 

C>] Inputs 

order 

SalesOrder 

10 Outputs 

result \ f 

string 


_5. Add an Export to the assembly diagram 

An SCA Export component exposes a service from an SCA project allowing it to be invoked 
from an external caller. We now want to create an Export. 
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Once added, we rename it to be called ManufacturingExport. 
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_6. Add a JDBC outbound adapter 

In our scenario, we wish to interact with the Manufacturing database. To achieve this, we will 
utilize the JDBC Adapter provided with the product. We add an outbound JDBC Adapter 
which will begin the database adapter creation wizard. Before launching the wizard, be sure 
you know the connection parameters to the database as well as a suitable userid/password 
that will be used for connection authentication and authorizations. 
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When the wizard starts we are initially prompted to choose which version of the adapter to 
use. Currently there is only one. 
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When an adapter is created, a new SCA project is defined. This needs to be created only 
once for each type of adapter. The SCA project holds the implementation of the JCA adapter. 
Thankfully it can be treated as a black box and we will never need to go inside it. I suggest 
giving the adapter project a name that reflects its purpose. 
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When the JDBC adapter is defined, it needs to know how to connect to the database. This is 
used during construction of the JDBC configurations. Part of the definition of how to connect 
to the database is to name the Java JAR files or other artifacts that provide the JDBC 
connections to a database. The location of these JAR files will vary depending on your own 
installation. It is recommended to use the files that come provided with your own DB system. 
IBM also provides an instance of drivers that may be suitable defaults if no local DB drivers 
have otherwise been installed. These can be found at the following location: 

C:\IBM\WebSphere\AppServer\jdbcdrivers\DB2 

These paths to the the DB jar files we desire to use are entered in the next panel. 
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We have now told the wizard which libraries to use to connect to the database and what 
remains is to tell the wizard which database to connect to. We select the type of database 
and based on the type, we next select connection properties for that kind. In our story, we are 
connecting to a database called MANUFAC that is hosted on a DB2 database. We also 
provide the userid/password combination that provides authorization information to allow us to 
connect. 
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The nature of the JDBC adapter is that it will build service operations for each database 
artifact against which we are interested in working. The next page of the wizard asks us to 
execute a query against the database to retrieve a list of possible artifacts. Click on the Run 
Query button to execute the query. A connection to the database will be made using the 
parameters previously entered. This connection will be used to retrieve a list of the possible 
artifacts. 
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From the list we select the table also called manufac and add it to the list of selected objects. 
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In the list of possible operations that can be performed against our database, we only wish to 
use the create method. This will perform database inserts. In addition, be sure to un-check 

the "generate a business graph for each business object". 
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The next page asks for runtime details that will be used when the adapter actually executes in 
a solution. The two entries of interest to us are username/password and DataSource JDBC 
name. The username/password is the identity that will be used at runtime to connect to the 
database. The DataSource JDBC entry is a pointer to the WAS configured JDBC DataSource 
definition. 
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The final page of the Wizard is the name of the SCA Import that will represent the JDBC 
adapter. 
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At the conclusion, we will find a new SCA Import on the assembly diagram that represents the 
database access. 


■i© ^Manufacturing - Assembly Diagram 

<] ■" Palette 
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l23 Favorites 
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^ Java 

Mediation Flow 

O Prnrp^ 



_7. Import the WSDL for the factory web service 

In our scenario we also want to interact with the service provider for the Factory Floor. When 
called, this service will start the production of the custom widgets. This service already exists 
and happens to be exposed as a Web Service provider. What we now need to do is import 
the WSDL description for this service so that it can be included in our solution. 
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Business Integration £3 
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> ^7 JDBCAdapterProject 


ifi. Manufactur' 


> Assemb 
Depend 

[ Integrat 

> ^3 Data 
j l© Interfao 

® JDBC 
® Man 
(?§ Transfoi 


New 

Open Deployment Editor 
Open Data Map Catalog 
Show Files 

Show References in References. View 
Associate with Process Center 

Iffll Copy 
Q| Paste 
1C Delete 

Ref a cto r o r An a lyze Im pact 

r?' M| n Import... 
ntij Export... 
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Close Project 
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In the import types selection, we select Business integration > wsdl and xsd. 
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A wizard is started asking us where we are to locate the artifacts. The choices are from the 
local file system or by direct retrieval from the service provider itself. We choose the direct 
retrieval option. 


Q Import 1=1 ! Jp 

Import a WSDL XSD or Both 

Select whether you want to import a local ora remote WSDL or XSD file. If you are importing locally,, 
you can import both a WSDL and an XSD file. 

O Local WSDL or XSD file, or both Import a WSDL or XSD file, or both, from a location on your computer. 




o Remote WS D L or XS D f i le 



Import a WSDL or XSD file from an external location that is accessible from a 
URL. The remote WSDL or XSD file is saved locally on your computer. 



Cancel 
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The URL we enter for the target web service is going to be provided to you in some other 
form. Be sure to select the two check boxes to separate out the Business Object and 
Interface definitions that are retrieved. 



_8. Create the Web Services Import 

Now that we have imported the WSDL describing the remote service, what remains is for us 
to define a Web Services import SCA component that will invoke this service. We start by 
adding an SCA Import into the SCAAssembly Diagram. 
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Show Display Name 
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The result of this will be a new SCA Import with no details associated with it. 




Facto ryFloorlmport 


Next we add an interface to the import. 


|j^ Facto ryFloorlmport 

* 

Undo Move 

^ Redo 


@3 Add Note 

Hide Notes 


Add Interface 

Generate Binding... ► 

Edit Binding... 

Remove Binding 

Refactor... ► 
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The interface type to be added is called FactoryFioor. This arrived as a result of importing 
the WSDL definition. 


0 Add Interface 


0 U3H 


Filter by interface or qualifier [? = any character, * = any string]: 


New.., 


Matching interfaces: 



© Show WSDL and Java 
m Show WSDL 
© Show Java 

Qualifier: 


(l h ttp ://F a cto ry FI o o r/F a cto n/F I o o r - M a n uf a ctu ri n g/l o c a I h o 


OK 


Cancel 


Once the interface type has been associated with the import, it is time to configure the 
bindings. The bindings define how the SCA import will call the remote system. In our case 
we want to use Web Service bindings. 
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In the wizard that appears for Web Service bindings, we need to specify port information. 
Click the Browse button. 



We find the details of an existing port. This again was obtained from the imported WSDL 
definition. 
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The next page of the wizard asks us what type of internal implementation we wish to use for 
Web Services calls. We choose JAX-WS which is the default. 
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That was the last step of the Web Service configuration and we can complete the task. 


O FactoryFloorlmport Web Service Import Details 

@ Use an existing web service port 

Port: Wo rkO rd er_F a cto ny FI o o rHttp P o rt 




Browse 


(_) Generate a new web service definition and implementation 

This will launch J2EE tools to help build and configure your 
service. 

This option is only recommended for advanced users. 

Q Do not specify a web service port at this time 



The end result is a new SCA Import component which has both an interface and associated 
bindings type. 


FactoryFloorlmport 


1 


9. Build the BPEL Process 
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We now have all the interaction parts defined. We have an export that allows the module to 
be externally called and two imports that describe the back-end systems with which we wish 
to interact. Now we must define the orchestration that controls the overall routing of the 
requests. There are a number of ways that this can be achieved. For this story, we choose 
BPEL as the choreographer controller. We start by adding a BPEL process to our diagram. 


<y Undo Add Binding 

Redo 

Revert 


@3 Add Note 

Hide Notes 


q£ Cut 

Hi Copy 

Paste 


K Delete 

Select All 


Add... ► 

Lr ' Unhyped Component 

Merge Components 
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Q Process 

Ejg-j Rule Group 

T_. State Machine 

(±^ Zoom In Ctrl+= 

Zoom Out Ctrl+- 

Automatic Layout 

[j£ Import 


At the conclusion, a new BPEL activity is added to the diagram which we rename to be called 

ManufacturingProcess. 


£ 


Manuf acturingProcess 


Next we wire it into place with relationships to the other export and imports. The result looks 
as follows. 


JDBCImport 


51 


ManufactuingExport 


OS Manuf acturingProcess 
@ _ 


©£ FactoryFloorlmport 


By wiring in this fashion, the BPEL process now knows its own interface and the interfaces of 
the partners that it is able to invoke. We are now ready to create an implementation of the 
BPEL process. 
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JDBCImport 
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Add Note 
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Add... 

ChangeType... 

Convert to Import 
Generate Export... 

G en erate Im p I em entati o n 
Sel ect Im p I em entati o n 
Open 

Synchronize Interfaces and Referenc es .. 
Refactor... 


© G en erate Im p I em entati on a | [°] ? [ 


Select the folder where the Process implementation will be generated: 




Once done, we end up with a skeleton BPEL process. What we wish to do next is to add in 
the BPEL activities that we will use. The following shows the process with activities inserted 
into it. 
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Receive 

| □ Assign 
^ Invoke 
q Assignl 

I 

^ Invoke! 
d Assign2 

I 

[ ^ Reply 


© 


After renaming, they make more sense. 




j ^3 Receive 
| a Prep for DB Insert 
Insert into DB 

i 

| “ Prep for Factory Floor 
^ Invoke Factory Floor 

i 

| a Set Result 
' ^ Reply 

Now it is time to start adding details to each of the activities so that at runtime, we execute the 
logic that we wish performed. 

First we associated the insert into DB Invoke activity with the JDBC Import partner. 
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S"§ Task Flows | Cq Build Activities 

O Properties Problems j|] Sen/er Logs Sen/ers 

invoke - Insert into DB 

* _ . _ 


Description 


Partner:* 


(none) 


Browse... 


Details 

Server 

Administration 
Exit Condition 
Compensation 
Correlation 
Expiration 


Interface:* 

Operation:* 

1~1 Use data type variables mapping 
Request:* 

Response:* 


Browse... 


Browse... 



Once done, we need to define variables for both the input and output parameters of the 
service call. 
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S"§ Task Flows 05 Build Activities it] Properties £3 Problems] H) Server Logs| Servers 


invoke - Insert into DB 


Description 


Partner:* 


JDBCImportPartner 


Browse.. 


Details Interface::* JDBCIniport 


Server 

Operation:* 

[yl Use data type vari 

createKolbanManufac ^ 



Administration 

Exit Condition 

iables mapping 

Compensation 

Name 

Type 

Read from Variable 

Correlation 

C>] Inputs 

createKolbanManufacInput 

KolbanManufac 



Expiration 


Name 


St. 


|Q| Browse... 

Q New... 

Environment 

[£> Outputs 

createKolbanManufacOutput 

KolbanManufac 

< 

Event Monitor 

<z i L-. i Cw^.,4- 






S"§ Task Flows Q]s Build Activities ^3 Properties £3 jfj. Problems J] Server Logs Servers 

rS ~ ' 

# Invoke - Insert into DB 



Description 


Details 


Server 


Administration 


Exit Condition 


Event Monitor 


Partner:* 

Interface::* 

Operation:* 

■/ Use data type variables mapping 


JDBCImportPartner 
JDBCImport 

createKolbanManufac t 


Browse... 


Compensation 


Name 


Read from Variable 

Correlation 

C>] In 

c reateKo 1 b a n M a n uf a cln p ut 

KolbanManufac 

createKolbanManufacInput ■=[> 

Expiration 


Name 

Type 

Store into Variable 

Environment 

10 Outputs 

createKolbanManufacOutput 

KolbanManufac 

■=[> createKolbanManufacOutput 


Prior to invoking the DB insert service, we need to populate the variable that will be used as 
input to the service. In the Prep for db insert Assign activity, we perform the mapping 
from the SalesOrder to the input data structure for the DB insert. 


S"§ Task Flows Cq Build Activities ^ Properties £3 ^Problems 8|] Server Logs ^4 Servers 

a ~ “ n] 

= Assign - Prep for DB insert 



Description 

Details 

Sen/er 

Exit Condition 
Environment 
Event Monitor 
[nlnhal Fvent Settinns 


Assign From 

O 

Assign To 


order orderNumber 

x$ 

O 

0 

createKolbanManufacInput ordernumber 

xy: 

* 

order widgetColor 

x$ 

■=[> 

$ 

createKolbanManufacInput color 

x$ 

ft 

order widgetSize 

x$ 

■=[> 

* 

createKolbanManufacInput size 

x$ 

* 

o rd er wi d g etWei g ht 


■=[> 

$ 

createKolbanManufacInput weight 

*$ 


For the invoke Factory Floor invoke activity, again we associate a partner and this time 
it will be the FactoryFioorPartner. In addition, we create a variable to be used as a 
parameter to the service call. 
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Sq Task Flows 

[Q5 Build Activities Properties . j£ ■: Problems 

| f||| Server Logs 

y% Servers 

invoke - 

invoke Factory Floor 




Description 


Partner:* 


Facton/FloorPartner 


Browse... 


Details 

Server 

Administration 

Exit Condition 

Compensation 

Correlation 

Expiration 

Environment 


Interface:* Facto ryFloor 

Operation:* createWorkOrder 

[7l Use data type variables mapping 



Name 

Type 

Read from Variable 

C>] Inputs 

order 

WorkRequest 

workRequest 

■=[> 


In the Prep for Factory Floor assign activity, we populate the variable used as input to 
the service. 


Properties 


! Assign - Prep for Factory Floor 


Description 


Details 


Sen/er 


Exit Condition 


Environment 


Event Monitor 


Global Event Settings 


Assign From 

■=[> 

Assign To 

if order orclerNumber 

xS 


# wo rkReq u est o rd erN umber 


if order widgetColor 

x$ 

■=[> 

# workRequest color 


if order widgetSize 



% workRequest size 


if order widgetWeightj 


■=[> 

# wo rkReq u est wei g ht 



Add 


Remove 


Up 


Down 


The final activity we wish to change is the Set Result Assign activity. Here we set a result 
of the process execution as a whole. 


S"§ Task Flows Build Activities Properties Problems" Server Logs Servers 


tS 


= Assign - Set result 


Description 

Details 

Server 

Exit Condition 
Environment 
Event Monitor 
Global Event Settings. 



x 


A BPEL process can be configured as either Long-Running or Microflow. Microflow is 
applicable to straight-through processes and can dramatically improve performance. In the 
BPEL process details settings, we switch the BPEL implementation type to be Microflow. 
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So Task Flows |Cq Build Activities [ □ Properties Problems] ft] Server Logs] tfi Servers] 




□ 


Process - ManufacturingProcess 


Description 


Details 


Server 


Administration 


Java Imports 


Defaults 


Im ports 


Environment 


Event Monitor 


Global Event Settings 


General Settings 

BPEL process type ^ Long-running process 

Uses IBM Process Server extensions 

0 Select the date when the process becomes valid: 


Ref actor to Microflow. 


June 14, 2011 


Select Date 


Time zone: America/Chicago Time: 16 v] : 9 tj: 20 ^ Refactor... 


Settings for Long-running Processes 

Automatically delete the process after completion: On successful completion 

Bind the life cycleto the invoking BPEL process 


S"§ Task Flows Cq Build Activities ^ Properties £3 [fj, Problems jlj] Server Logs Servers 

a " °j 

% Process - ManufacturingProcess 



Description 

Details 

Server 

Administration 
Java Imports 
Defaults 
Imports 
Environment 


General Settings 

BPEL process type: Microflow 

Uses IBM Process Server extensions 


Refactorto Long-running Process ... 


[V] Select the date when the process becomes valid: 


June 14, 2011 

Select Date 

Time zone: America/Chicago Time: 

16 & 

* & 


Settings for Long-running Processes 
Automatically delete the process after completion: 


We have now completed the construction of our BPEL process and module. 


10. Create the JDBC Data Source 


When we created our JDBC Adapter definition, we said that the database to which we are 
going to connect has a JNDI name of j dbc/MANUFAC. This means that we need to create 
the corresponding definition in the runtime of the Process Server. We perform this in two 
steps. The first is the creation of a J2C security alias that allows us to define a 
userid/password pair required for a database Data Source definition. Once done, we create 
the Data Source definition itself. 

We launch the IBM Admin Console and navigate to Security > Global Security and 
find the J2C authentication data link on the right hand side. 
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SSL certificate and key management 
Security auditing 
Bus security 


0 Environment 
0 Integration Applications 
0 System administration 
0 Users and Groups 
0 Monitoring and Tuning 
0 Troubleshooting 
0 Service integration 
El UDDI 


Global security 

Use this panel to configure administration and the default application security policy. This security configuration applies to the security policy 
administrative functions and is used as a default security policy for user applications. Security domains can be defined to override and custor 
policies for user applications. 


Security Configuration Wizard | Security Configuration Report | 


Administrative security 

0 Enable administrative security ■ Administrative user roles 
Administrative group roles 
Administrative authentication 

Application security 

0 Enable application security 

Java 2 security 

0 Use Java 2 security to restrict application access to local resources 
Warn if applications are granted custom permissions 
□ Restrict access to resource authentication data 

User account repository 

Current realm definition 

Federated repositories 

Available realm definitions 


Authentication 

Authentication mechanisms and expiration 
# LTPA 

Kerberos and LTPA 
Kerberos configuration 

© SWAM (deprecated): No authenticated communication 
Authentication cache settings 

g] Web and SIP security 
[+] RMI/IIOP security 

g Java Authentication and Authorization Service 
* Application logins 

■ System logins 

■ J2C authentication data 

□ Use realm-qualified user names 



■ Security domains 


we create a new security alias by clicking the New button. 


Global security 


Global security > JAAS - J2C authentication data 

Specifies a list of user identities and passwords for Java(TM) 2 conne 
m Prefix new alias names with the node name of the cell [for comp 

Apply | 


\±\ Preferences 


N ew 


6 O Tl W 


S e 1 ect 

Alias £ 

User ID (J: 

You can administer the following resources: 


□ 

BPCDE win7- 

xS4NodeOL.se rv erL Auth Alias 

db2admin 

□ 

BPCDB win7- 

x&4N a d eO L.server! Auth Alias XAR 

db2admin 


In the new alias, we enter a name, userid and password for the alias. 















































I Glob a I security 


Global security > JAAS - J2C authentication data > New 

Specifies a list of user identities and passwords for Javal[TM) 2 connector security to use. 
General Properties 

4 Alias _ 

| db2admin 

4 User ID 
| db2admin 

4 Pa 5 swo rd 

Description 



Ap p I y | QK | Reset | Ca nee I | 


It is now time to define the Data source that represents our database. Again in the WAS 
admin console we navigate to Resources > jdbc > Data sources. There we define 
that we are going to add a new Data source definition at the server level. 


Integrated Soluioits Console welcome admin 


Help I Lot 


View: All tasks 


Welc 


E Guided Activities 


El Servers 


E Applications 


El Services 


□ Resources 

■ Schedulers 

■ Object pool managers 
0 JMS 

■ Peo p I e d i recto ry p rovid er 

■ Extended messaging provider 

■ WebSphere Business Integration Adapters 
E JDBC 

■ JDBC providers 

■ Data sources 

■ Data sources (WeDSphere Application 
Server V4) 

■ Business Integration Data Sources 
E Resource Adapters 

E Asynchronous beans 
E Cache instances 
E Mail 

□ Remote artifacts 
E URL 

E Resource Environment 


0 Security 


E Environment 


Cell=win7-x64Node01Cell. Profile=ProcSrvOl 


Data sources 

Use this page to edit the settings of a datasource that is associated with your selected JDBC provide! 
application with connections for accessing the database.. Learn more about this task in a guided actk 
task steps and more general information about the topic. 

E Scope: Cell=win7-3tG4Node01Cell r Node=win7-x54Node01 r Server=serverl 

Scope specifies the level at which the resource definition is visible. For detailed information 
what scope is and how it works, see the scope settings help. 


| Node=win7-xG4NodeO L r Server=serverl. HtH] 
E Preferences 




T est connection 


Manege state... 


B C --T f 


Select 

Name £ 

JNDI name 0 

Scope 0 

Provider 0 

You can administer the following resources: 

□ 

BPEDataSourceDb2 

jdbc/BPEDB 

Node = wi n 7 - 

xG4 NodeOi r Se rve r=s e rve r L 

DB2 Universal JDBC 
Provider (XA) 

□ 

Business Process 

jd bc^co m. i b m .vs .s i b 
/win7- 

x64NodeO 1.serve rL- 
BPC.win?- 

xG4 N o d e 01 Ce 11 . B us 

Node=win7- 

xG4 NodeOirSe rve r=s e rve r L 

DB2 Universal JDBE 
Provider (XA) 

Choreographer ME 

data source 

□ 

Business Space 

data source 

jdb^mashupDS 

Node=win7- 

xS4 NodeOLfServe r=s e rv e r L 

Business Space JD 
Provider 







A database Data Source definition wizard is started for us. In the wizard, we enter 
jdbc/MANUFAC as the identity for this definition. 
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Create a d ata sou rce 


Create a data source 


Step 1: Enter basic 
data son rce 
information 

Step 2: Select JDBC 
provider 

Step 3\ Enter 
database specific 
properties for the 
data source 

Step 4: Setup 
security aliases 

Step 5: Summary 


Enter basic data source information 


Set the basic configuration values of a datasource for association with your 
JDBC provider,. A datasource supplies the physical connections between the 
application sender and the database,. 

Requirement: Use the Datasources [WebSpherel[R) Application Sender V4) 
console pages if your applications are based on the Enterprise JavaBeans(TM) 
(EJB) L.O specification or the Java(TM) Servlet 2.2 specification. 

Scope 


ce I Is : wi n 7 -x64 NodeOLCell:nodes:wi n 7 - 
x 64 NodeOLise r: e rs : s e rve r 1 


# Data source n- 
IM AN U FAC 


# JNDI name 
| j d bq.' MAN U FAC 4 




Next 


Cancel 


We select our database provider. We will find that a DB2 driver is already present. 



Next we define which database this Data Source associates. We select the manufac 
database at the local machine. 
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Create a data source 


Create a data source 



Next we name the security alias that we defined earlier as the identity for a number of the 
internal Data Source operations. 



Finally we confirm that we have completed the task. 
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Create a data source 


Create a data source 


Step 1: Enter basic 
data source 
information 

Step 2: Select JDBC 
provider 

Step S: Enter 
database specific 
properties for the 
data source 

Step 4: Setup 
security aliases 

Step 5: Summary 


Summary 

Summa^ of actions: 


Options 

Values 

Scope 

ce 1 Is : wi n 7 -xG4 N o d e 0 1 Ce 11 : n o d es : wi n 7 - 
xG4 NodeOL:servers:se rve r 1 

Data source name 

MAN U FAC 

JNDI name 

jdbc/MANUFAC 

Select an existing JDBC provider 

DB2 Universal JDBC Driver Provider l[XA) 

Implementation class name 

co m. i b m. d b 2 .jcc» D B 2XAD ata Sou rce 

Driver type 

4 

Database name 

MAN U FAC 

Server name 

local host 

Port number 

50000 

Use this data source in 
container managed persistence 
(CMP) 

false 

Authentication alias for XA 
recove ry 

wi n 7 -xG4 Node01/db2admin 

Co m p o n e nt- managed 
authentication alias 

wi n 7 -xG4 Node01/db2admin 

Mapping-configuration alias 

(none) 

Co nta iner-managed 
authentication alias 

wi n 7 -xG4 Node01/db2admin 


Previous 


Finish 


_11. Deploy the solution to the server 

Now that we have completed the definitions of our solution, we can deploy it to the runtime 
server for unit testing. In the Servers view, bring up the context menu for the defined server 
and add the project to the server. 
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S"§TaskFlow& Cq Build Activities H Properties [Tj^ Problems 5|] Server Logs Serve 

hfi IBM Process Server v7.5 at Inralhnd- rStarterJl 



New 



Open 



Show In 


m 

Copy 



Paste 


u 

Delete 



Rename 


ff 

Restart in Debug 


Q 

Restart 



Restart in Profile 


■ 

Stop 


m 

Publish 



Clean... 


fcr 

Adel and Remove... 



Monitoring 


Q 

Create Tables and Data Sources 



Reconnect Debug Process 



View and Publish Changes to Sen/er 


Here we add the project to the server. 
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After a few moments, we will find that the solution has been deployed. 


Ifo Task Flows Qj) Build Activities Properties~[i?7 Problems | Iftl Server Loos <!>tA Servers S3 


a IBM Process Server v7 .5 at localhost [Started,. Synchronized] 
t> ||^g ManufacturingApp [Started, Synchronized] 


12. Launch the test client tool 


Integration Designer has an in-built testing tool that allows us to perform unit tests. We 
launch this from the Test Module menu item. 
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Undo Synchronize 

Redo 

Revert 

@3 Add Note 
Hide Notes 

Cut 

B Copy 
Paste 

H Delete 
Select All 

Add- 

Merge Components 

ShowTransaction Highlighting 
Remove Transaction Highlighting 

Zoom In 
Zoom Out 

Automatic Layout 
Layout Contents 

Test Module 

Show Display Name 

Show In 



Ctrl+= 

Ctrl+- 




[§ *Manufacturing_Test £3 


= EP 

Integration Test Client: Manufacturing_Test 



Everts 

► General Properties 



This area displays the events in a test trace. Select an event to display its 
properties in the General Properties and Detailed Properties sections. 

More... 


Wi 




H B 3H 


Invoke 


T Detailed Properties 


Specify the component, interface, operation, and input parameter values 
for the Invoke event, and then click the Continue icon in the Events area 
to run the test. More... 


Configuration: 

Module: 

Component: 

Interface: 

Operation: 


Default ModuleTest 


0 rd ers/M a n uf a ctu ri n g 


ManufacturingProcess 


Manufacturing 


startP reduction 


4 In iti a I req u est p a ra m eters: 

* @ Va I u e ed ito r 0 XM L ed ito r 


4 


hin the context of the test tool, we can select 


? a | B 

□ 

Name 

Type 

Value 


U order 

Sales Order 

riEi 


orderNumber 

int 

E0123 


!□ widgetColor 

string 

EaH Blue 


[£□ widgetSize 

int 

EaH 12 


!□ widgetWeight 

double 

SH1.23 I 














he ManufacturingProcess componen 


and supply input values. 


After execution, the results of the run are shown. 
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At the conclusion of this run, we will find a new row in the manufacturing database and a log 
in the console of the Factory floor web service saying that the request to start the construction 
has begun. 

We have successfully completed the first part of our scenario. We have built an SCA module 
that exposes order processing from a manufacturing perspective. 

In the next part, we are going to build out a BPMN process that will invoke this SCA module. 
We will now start working with the thought in mind that this SCA module could be any SCA 
module that may already exist. We are going to build out the BPMN process to include an 
existing service (the one we just completed building). 


_13. Create a new Process App and BPD 

We create a new Process App called Orders and open it in Process Designer. Use Process 
Designer to create a new Process Application called Orders. When done, create a Business 
Process Definition (BPD) that we will also call Orders. 
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_14. Open up the Process App in Integration Designer 

Back in Integration Designer, switch to the Process Center perspective and open the Process 
Application called Orders in the Integration Designer Workspace. 
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We will be prompted for what we wish to import so just select the defaults. 


y Open Process Applications orToolkits in Workspace 

Select process applications or toolkits to open in the workspace: 
J S Orders 

[Hi t ^7 Ordcomplementation (to be initialized) 
jyj Grders_Libran/ (to be initialized) 


Select All 


Select Required Only 


OK 
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_15. Associate our Manufacturing SCA module with the Process Application 

For BPMN processes to be able to call SCA modules, the product expects Business Objects 
and Interfaces exposed by an SCA module for external calling to be included in an SCA 
Library project. Since we created our solution as one single module, we must re-factor our 
solution. Fortunately this is very straightforward to achieve. 

First we create a new Library in our solution that will be used to hold the artifacts we wish to 
expose. 


New 

Focus Business Integration View on Orders 
Show References in References View 

Associate with Process Center 
ChangeToolkit Dependencies 
Refresh and Publish 
Refresh from Process Center 
Replace With 


► Project 

[3 Business Object 

[_f Busin ess 0 bj ect fro m Extern a I Data 

(0 Interface 

External Service 

^ BP EL Process 
^ BPEL Process from IBM Forms 

► W Mediation Flow 


£ 

Integration Solution 

© 

Module 

$ 

Mediation Module 


Library j ^M_] 


Co m p o n ent Test P roj ect 


Business Monitoring Project 


Project.,, 


We will call this new library Manufacturing_Library. 



When we create the new library, we are prompted to add the new library to an existing 
Process Application which is, in this case, exactly what we do wish to do. 
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Once we have created the new but empty library, we wish to move artifacts into that library. 
First we will move the SalesOrder business object: 
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Business Integration 


Call resotirces> 

[> Orders Main 
> £7 JDBCAdapterProject 
a ^ Manufacturing 

[> Assembly Diagram 
^ Dependencies 
> (Jff Integration Logic 
a ^3 Data 

Q IntegrityConstraintFault 
KolbanManufac 

O MatchesExceededLimitFault 
M MissingDataFault 
f°l MultipleMatchingRecordsFault 
f°1 ObjectNotFoundFault 
H Priman/KeyPairType 
Q RecordNotFoundFault 


Q SalesOrdei 

rl 


Q UniqueCo 
Q WBIFault 
Q WorkRequ 
t> @ Interfaces 

Transformatic 

> Web Sen/ice P 

New ► 


Open 

Open With ► 

Show Files 

Show References in References View 

Add To Favorites 



Hi c °py 

(j^ Paste 

H Delete 


Refactor or Analyze Imp act ► 

Rename.,. 


r?' a -n Import,.. 

rLilJi Export... 

Move... 

Change Namespace,,. 


Refresh 

Configure Business. Object Parsing Mode... 

iIfi r rpatp a Rncmpcc fnranh 

Extra ct In -1 i n ed B u s i n ess 0 bj ects .,. 



Once we have selected the object and said that we wish to move it, we name our destination. 
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?g: Business Integration £3 


<al resources:* 

> [changed] Orders Main 

> ^7 JDBCAdapterProject 
a ^ Manufacturing 

> ^ Assembly Diagram 
2 Dependencies 

[jfj Integration Logic 

> 0 Data 

a Interfaces 

(D FactoryFloor 
® JDBCImport 



New 

► 


Open 

Open With 

Show Files 

Show References in References View 

► 


Add To Favorites 



Copy 



Paste 


X 

Delete 



Refactor or Analyze Impact 

► 


Import... 


i?-^i 

Export... 


a 

Refresh 



Export as Image,,. 


r 

Generate Documentation,,, 



Rename., 

Move.., 

Change P 

Extra ct WSD L C o m p o n ents... 
Merge Interfaces... 
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Once the library has been built and populated, we can then associated the projects with 
Process Center. 
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h- Business Integration £3 


<all resources> 

[> [changed] Orders Main 

t> 6^7 JDBCAdapterProject_ 
t> Manufacturing 


t> Manufacuring_Libr 


New 

Open 

Associate with Process Center 

UBl Copy 
[1 Paste 
% Delete 

nAs\ Import... 
hliji Export... 

Refresh 
Close Project 

Validate 

Team 

Compare With 
Properties 


Ensure that we select the Orders Process Application as the target. 
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Upon completion, the result will look as follows. We now see that the SCA module is now part 
of the Orders Process Application. 


h: Business Integration £3 

<all resources:* 
a [changed] Orders Main 

/ f. Advanced Integration Sen/ices 

> SCA Exports 

> 1 Processes 

Dependent Toolkits 

> ^7 JDBCAdapterProject 

> Manufacturing 

> Manufacuring_Library 

> Qrd complementation 

> 1J7 Orders_Library 


_16. Complete the export bindings of our SCA module 

In order for our SCA module to be called from BPMN, it must have its SCA Export defined as 
having an SCA Binding. We select the export and give it an SCA binding. 
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« 


^ ManufactuingExport 


O ManufacturinqProcess 

Undo 

Redo 


JDBCImport^ 


^ '-A FactoryFloorlmport 


Add Note 
Hide Notes 

Add Interface 
Generate Binding... 
Edit Binding... 
Remove Binding 
Refactor... 

Cut 

III Copy 


► 

Enterprise JavaBeans Binding 



HTTP Binding 



Messaging Binding.. 

► 

► 

SCA Binding _I 



Web Service Binding 



In the binding section, we see that the the export is defined as being visible to the IBM 
Process Designer which is where we make our BPMN definitions. 


S"§ Task Flows Cq Build Activities S Properties £3 jli, Problems [||] Server Logs Servers 

% Export: ManufactuingExport (SCA Binding} 

Description 

[71 Make operations visible to IBM Process Designer 

Details 

Binding 


All Qualifiers 



17. Publish the work back to Process Center 


Now that we have completed our tasks in Integration Designer, it is time to publish the work 
back to Process Center. Click the Refresh and Publish button to push the work back to 
the server. 
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s\ 


Business Integration £3 


call resources:* 


a L [changed] Ordr 


& 


■/ f Advanced I 
[3 Processes 
■ Dependent 
JDBCAdapt 
0 Manufactu 
I> ^§1 Assemb 
S Depend 
t> Integrat 
> £7 Data 
t> [f§. Interfac 
(25 Transfo 
t> Web Se iL^H 
11 ' Manufacur 
0 Orders_Imp 


New 

Focus Business Integration View on Orders 
Show References in References View 

ChangeToolkit Dependencies 
Refresh and Publish 
Refresh from Process Center 
Replace With 
Delete from Workspace 

Import... 

Export... 


Q Library Mirroring 





It has been detected that you are publishing newXSD resources to 
a mirrored library that can be accessed by Process Designer users. 
If the newXSD resources are modified in Process Designer, the 
data types will be greatly changed and will negatively impact all 
res o u re es th at referen c e th em. 


PuttheXSD resources in a toolkit and set permissions to prevent 
Process Designer users from editing them. More... 



_18. Finish out the BPMN process definition 

In our BPMN BPD back in Process Designer, we are now ready to add the call to the 
Manufacturing system. Add an activity into the System Lane and call it Send to Manufacture. 
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Because it was added to a System Lane, we can select the Implementation tab and choose 
its implementation type as an automated service. Click the Select button and search for our 
Manufacturing service. We will find it in the Advanced Integration Service section. This was 
defined when we published our Process Application from Integration Designer back to 
Process Center. 





Advanced Integration Service 
Manufacturing 



►4 


The end result will look as follows. 
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Validation Errors Where Used 


Step 

Simulation 
Implementation 
Routing 
Data Mapping 
Pre & Post 
KPb 

Condition 


▼ Implementation 


Service [automated) ▼ Manufacturing 


We still have one more task. The BPMN activity needs input and output data. Switch to the 
Data Mapping tab and click the auto mapping button. This will create variables for the inputs 
and outputs. 


Properties 


Validation Errors Where Used 


Step 

Simulation 
Implementation 
Routing 
Data Mapping 
Pre & Post 
KPIs 

Condition 


▼ Input Mapping 


% 


W ut Mapping 

<=[> order [Sale:Order) result [String) <=[> 


Q Create variables for auto-mapping 


Auto-map did not find variables for all parameters. You can now select to create 
p rivate va ri a b I es fo r th es e p a ra m eters if wa ntecl : 


0 ^ order [SalesOrder) 


OK 


Properties 


Validation Errors Where Used 


Step 

Simulation 

Implementation 

Routing 


▼ Input Mapping 


& tw . local . order 


^ ▼ Output Mapping 

order [SalesOrder) result [String) <=D 


5 


&tw. local.result 


4 * 


For the input variable, we need to supply some default values (remember this is a sample). 
Switch to the Variables tab and select the order variable. Add some default values. 
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Orders 


▼ Variables 


Variables 
Local 
=Q Input 
G> Output 
a © Private 


> @ order (SalesOrder) 


© result (String) 
Exposed Process Variables 


Add Private 


Add Input 


Add Output 


Link Epv 


Remove 


Move Up 


Move Down 


▼ Details 

Name: 

Documentation: 


order 


Is List: 

Variable Type: 

▼ Default Value 

Has Default: [V] 


□ 

Sales Order 


Select,. 


New 


Property 

Value 

orderNumber 

567 A 

widgetColor 

"Brown" j 

widgetSize 

19 

widgetWeight 

12.34 * 


▼ Business Data Search 

I _ 

II-. V...L-.. I I 


19. Run the solution 


We have now completed the construction of our solution. We can now run the BPD from 
Process Designer and validate that the back-end SCA module was in fact called. 
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O IBM Process Designer - tw_admin - Orders - Main 
File Edit Playback Help 


Designer Q Inspector Q Optimizer LJ 

Save 


GB All versions 


r^l~a~ E 


B >• ? 

Snapshot Process Center Help 


Process Instances 


Services in Debug 


Instance Name: 
Instance Name 
Orders:259 


Snapshot Process 
Tip Orders 


Status Due Date Insta Status 

Completed Jun 29,20... 259 


Owner Subject 


Priority Due Date 


► «L 



Variables Tracking Process KPIs 


o 

End 


Send to 
Manufacture 


Execution State 


Breakpoints 


♦c BPD Instance (#259) 
Q Execution Tree 
99 Orders 


a Local Variables 
% result 
& order 

Completed 


• deployed • localhost 


Summary 

In this exercise we built a simple solution that involved integration with database and external 
web services in a simple fashion through an Advanced Integration Service (AIS). 
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Environment setups 


Creating the Database Tables 

This exercise assumes that there is a DB2 database called MANUFAC which has a table on it 
also called MANUFAC. I am assuming you know how to create tables in a DB2 database. 

The table schema that was used in this exercise looks as follows: 


ffl Table - MANUFAC 

Schema : KOLBAN 

Creator : KOLBAN 

Columns : 4 

Actions: 

Open 
^ Query 

^ Show Related Objects 

O Create Mew Table 


(g) Help x 


Columns 


Key 

Name 

Data type 

Length 

Nullable 


ORDERNUMBER 

INTEGER 

4 

No 


COLOR 

VARCHAR 

40 

No 


SIZE 

INTEGER 

4 

No 


WEIGHT 

DOUBLE 

8 

No | 


The database Schema (eg. Kolban) is un-important and will likely change in your 
environment. You just need to make sure that when creating the JDBC Adapter you map 
correctly and also ensure that the runtime connection userid/password supplied has authority 
on this table and database. 


Creating the Factory Floor Web Service 

A sample Web Service that implements the Factory Floor service is provided with this 
demo/lab. It is provided as a Integration Developer Project Interchange file. The Assembly 
for the service is ridiculously simple and looks as follows. 



WorkOrder © H, Factory 


The service merely logs the incoming message to the console to show that it was actually 
called. 


Resetting after a test 

After having run a test of this scenario, you may want to clean your environment so that all 
trace of the tests have been removed. You may want to do this just for clean-up or for re¬ 
running the tests. 

Delete the JDBC Data Source 


63 



















Integrated Sol u ions Console welcome ad™ 


View: Al I tas ks 


Welcome 


0 Guided Activities 


0 Servers 


0 Applications 


0 Services 


0 Resources 


■ S c h ed u I ers 

■ Object pool managers 
0 JMS 

■ Peo p I e d i recto ry p rovid er 

■ Extended messaging provider 

■ WebSphere Business Integration Adapters 
0 JDBC 

■ JDBC providers 

■ Data sources 

■ Data sources (WebSphere Application Server 

V4) 

■ Business Integration Data Sources 
0 Resource Adapters 

0 Asynchronous beans 
0 Cache instances 
0 Mail 

0 Remote artifacts 
0 URL 

0 Resource Environment 


0 Security 


0 Environment 


0 Integration Applications 


0 System administration 


0 Users and Groups 


0 Monitoring and Tuninq 


Cel I =wi n7-xG4NodeO ICel I, Profi le= ProcSrvD 1 


Data sources 


Data sources 


Use this page to edit the settings of a datasource that is associated with your 
supplies your application with connections for accessing the database,. Learn n 
guided activity provides a list of task steps and more general information abo 

0 Scope: Cell=win7-x04Node01Celll r Node=win7-x04NodeOl f Server=serverl 

Scope specifies the level at which the resource definition is visible. F 
information on what scope is and how it works r see the scope settinc 


Node=win7-xG4NodeO L r Server=serverL | -y | 


0 Preferences 


Select 

Name £ 

JNDI name 

Scope 0 


Filter: MAN* 




DeletE 




nnaction | ManagE statE.. 


SB O 


To filter the following table r select the column by which to fiIter r then enter fil 
F'r Search terms: 

Go I 


Name M l | MAN* 


You can administer the following resources: 


□ 


MAN U FAC 


jd be/ M AN U FAC 


Node=win7- 

xG4NodeO L r Server=serverl. 


Total 1 Filtered total: 1 
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